Program Annotations

The Program Annotations endpoint supports the Program Video Descriptors feature. Typically, most programs are annotated with 20-30 video descriptors, but this can vary depending on the content. For example, a documentary movie may be lightly tagged compared to a live-action franchise movie based on a comic book. Within each Video Descriptor type, there can be anywhere from 1-5 video descriptors each. Specifically for Series, tagging is done at a show level covering over-arching descriptors across seasons and episodes.

For certain genres of programs, some types may not be relevant. In such cases, video descriptors from that type will not be present. See Video Descriptor Coverage

Each Program, identified by its “TMS ID”, is annotated with Video Descriptors. The Program Annotations API provides the ID of the video descriptor. For each program object, Video Descriptors are grouped by video descriptor type. Within each video descriptor type, the video descriptors are sorted by descending order of importance. That is, the most important video descriptor for a given type appears first with ordinal number 1, followed by the next important video descriptor with ordinal number 2, and so on.

See the xsd for a more information about the Program Annotation schema: http://files.api.gracenote.com/xsd/on_update_programAnnotations_3.20.xsd